home *** CD-ROM | disk | FTP | other *** search
/ Sunday Savers: Singing Fun! / Sunday Savers: Singing Fun!.iso / mac / Xtras / Buddy API 1.6 / Buddy API Docs.swf / texts / 1554.txt < prev    next >
Encoding:
Text File  |  2004-08-31  |  4.0 KB  |  141 lines
  1. 139
  2. --- RECORDSEPARATOR ---
  3.  
  4. --- RECORDSEPARATOR ---
  5. GetFilename 
  6. --- RECORDSEPARATOR ---
  7. Platform:
  8. --- RECORDSEPARATOR ---
  9.  
  10. --- RECORDSEPARATOR ---
  11. Windows and Macintosh
  12. --- RECORDSEPARATOR ---
  13.  
  14. --- RECORDSEPARATOR ---
  15. Description:
  16. --- RECORDSEPARATOR ---
  17.  
  18. --- RECORDSEPARATOR ---
  19. baGetFilename displays a file dialog box and returns the filename selected.
  20. --- RECORDSEPARATOR ---
  21.  
  22. --- RECORDSEPARATOR ---
  23. Usage:
  24. --- RECORDSEPARATOR ---
  25.  
  26. --- RECORDSEPARATOR ---
  27. Result = baGetFilename( Operation, StartDir, Filename, Filter, Flags, Instruction, 
  28. --- RECORDSEPARATOR ---
  29. NoFolders, X, Y )
  30. --- RECORDSEPARATOR ---
  31.  
  32. --- RECORDSEPARATOR ---
  33. Arguments:
  34. --- RECORDSEPARATOR ---
  35.  
  36. --- RECORDSEPARATOR ---
  37. String, string, string, string, integer, string, integer, integer, integer. 
  38. --- RECORDSEPARATOR ---
  39. Operation is the type of dialog to show. Can be "open" or "save". 
  40. --- RECORDSEPARATOR ---
  41. StartDir is the initial directory. Use "" for the current directory. 
  42. --- RECORDSEPARATOR ---
  43. Filename is the initial file name to display. 
  44. --- RECORDSEPARATOR ---
  45. Filter is the type of files to display. Use "" to show all files. 
  46. --- RECORDSEPARATOR ---
  47. Flags modifies the behaviour of the dialog. 
  48. --- RECORDSEPARATOR ---
  49. Instruction is the instruction to display to the user. 
  50. --- RECORDSEPARATOR ---
  51. If NoFolders is true, the folder selection controls will not be shown. 
  52. --- RECORDSEPARATOR ---
  53. X is horizontal position of the dialog. 
  54. --- RECORDSEPARATOR ---
  55. Y is the vertical position of the dialog.
  56. --- RECORDSEPARATOR ---
  57.  
  58. --- RECORDSEPARATOR ---
  59. Returns:
  60. --- RECORDSEPARATOR ---
  61.  
  62. --- RECORDSEPARATOR ---
  63. String. 
  64. --- RECORDSEPARATOR ---
  65. Returns the file name selected, or "" if the user cancelled.
  66. --- RECORDSEPARATOR ---
  67.  
  68. --- RECORDSEPARATOR ---
  69. Examples:
  70. --- RECORDSEPARATOR ---
  71.  
  72. --- RECORDSEPARATOR ---
  73. Director: 
  74. --- RECORDSEPARATOR ---
  75. set filename = baGetFilename( "save", "c:\temp", "newfile.txt", "Text files|*.txt", 0, 
  76. --- RECORDSEPARATOR ---
  77. "Save new file", false, 100, 100 ) 
  78. --- RECORDSEPARATOR ---
  79. Authorware: 
  80. --- RECORDSEPARATOR ---
  81. file := baGetFilename( "open", "c:\\temp", "", "", 524288, "Select data file to open", 
  82. --- RECORDSEPARATOR ---
  83. true, -1, 0 )
  84. --- RECORDSEPARATOR ---
  85.  
  86. --- RECORDSEPARATOR ---
  87. Notes:
  88. --- RECORDSEPARATOR ---
  89.  
  90. --- RECORDSEPARATOR ---
  91. The filter argument consists of a series of strings separated by "|" characters. On
  92. --- RECORDSEPARATOR ---
  93.  
  94. --- RECORDSEPARATOR ---
  95. Windows
  96. --- RECORDSEPARATOR ---
  97. , the strings are divided into pairs, the first half of a pair is the description 
  98. --- RECORDSEPARATOR ---
  99. that appears in the drop down box, the second half is the wildcard for the files. 
  100. --- RECORDSEPARATOR ---
  101. Separate multiple wildcards with semi-colons. 
  102. --- RECORDSEPARATOR ---
  103. "Text files|*.txt" 
  104. --- RECORDSEPARATOR ---
  105. -- shows only text files 
  106. --- RECORDSEPARATOR ---
  107. "Text files|*.txt"|All files|*.*" 
  108. --- RECORDSEPARATOR ---
  109. -- 
  110. --- RECORDSEPARATOR ---
  111. allows the user to display either text files or all files 
  112. --- RECORDSEPARATOR ---
  113. "Images|*.bmp;*.tif;*.jpg" 
  114. --- RECORDSEPARATOR ---
  115. -- shows different image files 
  116. --- RECORDSEPARATOR ---
  117. On
  118. --- RECORDSEPARATOR ---
  119.  Macintosh
  120. --- RECORDSEPARATOR ---
  121. , the filter is the four character code of the file type eg ΓÇ£TEXTΓÇ¥. Up to 
  122. --- RECORDSEPARATOR ---
  123. 4 types can be specified, eg ΓÇ£TEXT|PICTΓÇ¥. 
  124. --- RECORDSEPARATOR ---
  125. Setting the NoFolders option to true will mean that the user will not be able to 
  126. --- RECORDSEPARATOR ---
  127. change the initial directory, and folders will not be shown. 
  128. --- RECORDSEPARATOR ---
  129. The X and Y values are the number of pixels from the top left corner of the screen. 
  130. --- RECORDSEPARATOR ---
  131. Set X to -1 to position the dialog in the center of the calling Director/Authorware 
  132. --- RECORDSEPARATOR ---
  133. window. Set X to -2 to position the dialog in the center of the screen. On 
  134. --- RECORDSEPARATOR ---
  135. Macintosh, if using the Navigation Services option then ΓÇô3 will position the dialog 
  136. --- RECORDSEPARATOR ---
  137. where the user left it.
  138. --- RECORDSEPARATOR ---
  139.  
  140. --- RECORDSEPARATOR ---
  141. (continued next page)